Conhecendo as integrações do Tactium x Actyon (JCA)

Objetivo

Documentar as integrações disponíveis entre a plataforma Tactium e a solução Actyon (JCA), detalhando métodos, padrões de comunicação e estruturas de dados necessários para uma implementação segura, padronizada e eficiente.

As integrações viabilizam a comunicação entre o CRM Actyon e as soluções de telefonia e OmniChannel da Tactium, abrangendo a carga de mailing, o acionamento de popup de tela a partir de eventos de atendimento e o disparo de mensagens via WhatsApp. Esse conjunto garante interoperabilidade entre as plataformas, consistência no fluxo de dados e automação dos processos operacionais.

Endpoints utilizados telefonia

Autenticação

Este método é obrigatório para obtenção do token de acesso, utilizado na autenticação das demais requisições da API.

Endpoint: POST /administracao/autenticar

Formato de envio: JSON

Exemplo de entrada:

{
	"usuario": "softium",
	"senha": "123456",
	"urlEventos": "https://hostname/app/service",
	"modeloEventos": "webhook"
}

Exemplo de saída:

{
	"status": 0,
	"mensagem": "",
	"dados": {
		"token": "ppJCiHfQ7wVa1OVeS4872iK1UZzruUZ86Rpvk3AFR1zytKjLIr7r-UKpnbytJAfrvG9_eGkKJnJc6UXzq1Z1xlqNEYIUvW3YdQuQkwDMT37vxED3zylAprYNeTrEsQ5SGYMtsJfB4_-vKCWbtxYI3swoimSpYo9ydh8BBPK7ZUkHutYDGQKhklnkp-JoKvKQ8CZiJTj0886QHFgEU71BixosWKtUy1KP0n3LKPRYgGiSvd4M-c8l343O1aX8NTxcQKtcRL92vs6a-AS5Kre5apLf_jK2qC-S2YPSTCJSuFGSrUIsMdO5QncOhHIvoSc1Ng4Sk9gPj3l6jjL9y5IlxIxjclNmztkzzVw9jhb_yQkl9FA3-C9wqAjZXGtIAz0vvGPMQlWeQ5vQpKjzksuHtMbzYo12pMEjL_5Jb_OayG3fVwTJDgZDHbIPLzDuVzYY3nMH6ovG6XfERd9JoJ8_kw",
		"expiraEm": "07/04/2026 23:59:59"
	}
}

O token retornado deve ser enviado no header das requisições no formato Authorization: Bearer <token>.

O parâmetro urlEventos define o endpoint que receberá eventos da aplicação, incluindo o evento de ligação atendida, utilizado para acionamento do popup de tela no Actyon.

Geração de Mailing

A carga de mailing é realizada por meio do envio de arquivos pré-processados na plataforma Actyon. Este processo é utilizado para alimentar campanhas e operações de discagem.

Método carregar_arquivo

Endpoint: POST /mailing/carregar_arquivo

Formato de envio: form-data

O layout utilizado é fixo (V14) e deve seguir rigorosamente o padrão definido na documentação de layouts. Arquivos fora do padrão poderão ser rejeitados ou processados com inconsistências. Para mais detalhes consulte <Link aqui>

Exemplo de saída:

{
	"status": 0,
	"mensagem": "",
	"dados": null
}

Popup de Tela (Eventos)

Após a autenticação, os eventos são enviados para o webhook configurado. O principal evento para integração com o Actyon é o de ligação atendida, responsável por acionar o popup de tela.

Evento: 12 (Ligação atendida)

Estrutura do evento:

{
	"evento": 12,
	"status": 0,
	"mensagem": "",
	"dispositivo": "2000",
	"dados": {
		"idChamada": "UUID",
		"idExterno": "",
		"dadosAssociados": "",
		"idServicoExterno": "",
		"dadosServicoExterno": "",
		"tronco": "",
		"foneOrigem": "",
		"foneDestino": "",
		"nomeServico": "",
		"tipoChamada": "",
		"statusChamada": "",
		"tipoAtendimento": "",
		"ura": [
			{
				"chave1": ""
			},
			{
				"chave2": ""
			}
		],
		"discador": {
			"idItem": "",
			"idExterno": "",
			"descricao": "",
			"infoAnexadas": "",
			"nomeCampanha": ""
		}
	}
}

Endpoints utilizados Omni

Disparos de WhatsApp

Autenticação

Este método é obrigatório para obtenção do token de acesso, utilizado na autenticação das demais requisições da API.

Endpoint: POST /administracao/autenticar

Formato de envio: JSON

Exemplo de entrada:

{
	"usuario": "softium",
	"senha": "123456",
	"urlEventos": "https://hostname/app/service",
	"modeloEventos": "webhook"
}

Exemplo de saída:

{
    "status": 0,
    "dados": {
        "token": "zRE5o4ST0uwCk-M8ArXLx3I-yZCTz2AmSSmVD5Jp4QQoqQJkzb-Flkl9QhxOUckjbMiQQGY1gMKZ1gAbr8lgIFcdJt2G86cA1yEYX96IqqKs_FWV1U-Yw8RASyB2H_JbjKJc544h0t8k8_ejdre3_QzqsU-ce8M0rJ4XrJekRvpEyObq-VJDmjOUbyFChDXyRQIAuBIetVBTQICKnJ8dCTnyPyamrHThHYDD1cEnPw6Rdu9d8PPl3c2xhEacz-nabkI5XtFlLOtXDx7ihyTrP14ce6ycZAJ2Fk7Zj4I8pt28yISQU0Kwae9QS7I4uKn-uiDeOYMx0XlIaDlFRic-KG1iyi5t4WkH1sshC_KMgw2h-FRfuL96CWGCUwt15eac8jPNBvZH31Bn7amcDpIvl-VqAMzhRs-dP3ORl5pjviU",
        "expiraEm": "08/04/2026 12:00:42"
    }
}

Método disparar

Endpoint: POST /WhatsApp/disparar

Formato de envio: JSON

Exemplo de entrada:

{
	"codCampanha": 99,
	"codExterno": "01010101001",
	"variaveis": [
		"variavel1",
		"variavel2",
		"variavel3"
	],
	"ddi": "55",
	"ddd": 85,
	"fone": 999999999,
	"nome": "Destinatário",
	"dataLimite": "2026-04-07T11:17:33.788Z"
}

Exemplo de saída:

{
	"status": 0,
	"mensagem": "",
	"dados": {
		"NotificationId": "2"
	}
}